home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / TopLevelShell.z / TopLevelShell
Text File  |  1998-10-30  |  18KB  |  265 lines
  1.  
  2.  
  3.  
  4.      TTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVTTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           TTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll - The TopLevelShell widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/Xm.h>
  13.           #include <X11/Shell.h>
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents Motif 2.1.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           TopLevelShell is used for normal top-level windows such as
  20.           any additional top-level widgets an application needs.
  21.  
  22.         CCCCllllaaaasssssssseeeessss
  23.           TopLevelShell inherits behavior and resources from CCCCoooorrrreeee,
  24.           CCCCoooommmmppppoooossssiiiitttteeee, SSSShhhheeeellllllll, WWWWMMMMSSSShhhheeeellllllll, and VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll.
  25.  
  26.           The class pointer is _t_o_p_L_e_v_e_l_S_h_e_l_l_W_i_d_g_e_t_C_l_a_s_s.
  27.  
  28.           The class name is TTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll.
  29.  
  30.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  31.           The following table defines a set of widget resources used
  32.           by the programmer to specify data. The programmer can also
  33.           set the resource values for the inherited classes to set
  34.           attributes for this widget. To reference a resource by name
  35.           or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  36.           prefix and use the remaining letters. To specify one of the
  37.           defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove
  38.           the XXXXmmmm prefix and use the remaining letters (in either
  39.           lowercase or uppercase, but include any underscores between
  40.           words).  The codes in the access column indicate if the
  41.           given resource can be set at creation time (C), set by using
  42.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  43.           not applicable (N/A).
  44.  
  45.                                 TTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  46.           NNNNaaaammmmeeee                  CCCCllllaaaassssssss                 TTTTyyyyppppeeee      DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  47.           XmNiconic             XmCIconic             Boolean   False     CSG
  48.           XmNiconName           XmCIconName           String    NULL      CSG
  49.           XmNiconNameEncoding   XmCIconNameEncoding   Atom      dynamic   CSG
  50.  
  51.           XXXXmmmmNNNNiiiiccccoooonnnniiiicccc If True when the widget is _c_r_e_a_t_e_d, specifies that
  52.                     the widget should start as an icon when it is
  53.                     realized. A value of False indicates that the
  54.                     widget is not to be realized as an icon. This
  55.                     resource will only override the XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllSSSSttttaaaatttteeee
  56.                     resource when specified in the call that creates
  57.                     the widget.
  58.  
  59.           XXXXmmmmNNNNiiiiccccoooonnnnNNNNaaaammmmeeee
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      TTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVTTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))
  71.  
  72.  
  73.  
  74.                     Specifies the short form of the application name
  75.                     to be displayed by the window manager when the
  76.                     application is iconified.  When XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss is
  77.                     called on this resource, the returned value is a
  78.                     pointer to the actual resource value and should
  79.                     not be freed.
  80.  
  81.           XXXXmmmmNNNNiiiiccccoooonnnnNNNNaaaammmmeeeeEEEEnnnnccccooooddddiiiinnnngggg
  82.                     Specifies a property type that represents the
  83.                     encoding of the XXXXmmmmNNNNiiiiccccoooonnnnNNNNaaaammmmeeee string.  If a language
  84.                     procedure has been set, the default is None;
  85.                     otherwise, the default is _X_A__S_T_R_I_N_G. When the
  86.                     widget is realized, if the value is None, the
  87.                     corresponding name is assumed to be in the current
  88.                     locale.  The name is passed to
  89.                     XXXXmmmmbbbbTTTTeeeexxxxttttLLLLiiiissssttttTTTTooooTTTTeeeexxxxttttPPPPrrrrooooppppeeeerrrrttttyyyy with an encoding style
  90.                     of XXXXSSSSttttddddIIIICCCCCCCCTTTTeeeexxxxttttSSSSttttyyyylllleeee. The resulting encoding is
  91.                     _S_T_R_I_N_Gif the name is fully convertible to _S_T_R_I_N_G,
  92.                     otherwise _C_O_M_P_O_U_N_D__T_E_X_T.  The values of the
  93.                     encoding resources are not changed; they remain
  94.                     None.
  95.  
  96.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  97.           TopLevelShell inherits behavior and resources from the
  98.           following superclasses. For a complete description of each
  99.           resource, refer to the reference page for that superclass.
  100.  
  101.                                            VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  102.           NNNNaaaammmmeeee                     CCCCllllaaaassssssss                    TTTTyyyyppppeeee            DDDDeeeeffffaaaauuuulllltttt           AAAAcccccccceeeessssssss
  103.           XmNaudibleWarning        XmCAudibleWarning        unsigned char   XmBELL            CSG
  104.           XmNbuttonFontList        XmCButtonFontList        XmFontList      dynamic           CSG
  105.           XmNbuttonRenderTable     XmCButtonRenderTable     XmRenderTable   dynamic           CSG
  106.           XmNdefaultFontList       XmCDefaultFontList       XmFontList      dynamic           CG
  107.           XmNdeleteResponse        XmCDeleteResponse        unsigned char   XmDESTROY         CSG
  108.           XmNinputMethod           XmCInputMethod           String          NULL              CSG
  109.           XmNinputPolicy           XmCInputPolicy           XmInputPolicy   XmPER_SHELL       CSG
  110.           XmNkeyboardFocusPolicy   XmCKeyboardFocusPolicy   unsigned char   XmEXPLICIT        CSG
  111.           XmNlabelFontList         XmCLabelFontList         XmFontList      dynamic           CSG
  112.           XmNlabelRenderTable      XmCLabelRenderTabel      XmRenderTable   dynamic           CSG
  113.           XmNlayoutDirection       XmCLayoutDirection       XmDirection     XmLEFT_TO_RIGHT   CG
  114.           XmNmwmDecorations        XmCMwmDecorations        int             -1                CG
  115.           XmNmwmFunctions          XmCMwmFunctions          int             -1                CG
  116.           XmNmwmInputMode          XmCMwmInputMode          int             -1                CG
  117.           XmNmwmMenu               XmCMwmMenu               String          NULL              CG
  118.           XmNpreeditType           XmCPreeditType           String          dynamic           CSG
  119.           XmNshellUnitType         XmCShellUnitType         unsigned char   XmPIXELS          CSG
  120.           XmNtextFontList          XmCTextFontList          XmFontList      dynamic           CSG
  121.           XmNtextRenderTable       XmCTextRenderTable       XmRenderTable   dynamic           CSG
  122.           XmNunitType              XmCUnitType              unsigned char   XmPIXELS          CSG
  123.           XmNuseAsyncGeometry      XmCUseAsyncGeometry      Boolean         False             CSG
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      TTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVTTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))
  137.  
  138.  
  139.  
  140.                                        WWWWMMMMSSSShhhheeeellllllll RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  141.           NNNNaaaammmmeeee               CCCCllllaaaassssssss              TTTTyyyyppppeeee      DDDDeeeeffffaaaauuuulllltttt                 AAAAcccccccceeeessssssss
  142.           XmNbaseHeight      XmCBaseHeight      int       XtUnspecifiedShellInt   CSG
  143.           XmNbaseWidth       XmCBaseWidth       int       XtUnspecifiedShellInt   CSG
  144.           XmNheightInc       XmCHeightInc       int       XtUnspecifiedShellInt   CSG
  145.           XmNiconMask        XmCIconMask        Pixmap    NULL                    CSG
  146.           XmNiconPixmap      XmCIconPixmap      Pixmap    NULL                    CSG
  147.           XmNiconWindow      XmCIconWindow      Window    NULL                    CSG
  148.           XmNiconX           XmCIconX           int       XtUnspecifiedShellInt   CSG
  149.           XmNiconY           XmCIconY           int       XtUnspecifiedShellInt   CSG
  150.           XmNinitialState    XmCInitialState    int       NormalState             CSG
  151.           XmNinput           XmCInput           Boolean   True                    CSG
  152.           XmNmaxAspectX      XmCMaxAspectX      int       XtUnspecifiedShellInt   CSG
  153.           XmNmaxAspectY      XmCMaxAspectY      int       XtUnspecifiedShellInt   CSG
  154.           XmNmaxHeight       XmCMaxHeight       int       XtUnspecifiedShellInt   CSG
  155.           XmNmaxWidth        XmCMaxWidth        int       XtUnspecifiedShellInt   CSG
  156.           XmNminAspectX      XmCMinAspectX      int       XtUnspecifiedShellInt   CSG
  157.           XmNminAspectY      XmCMinAspectY      int       XtUnspecifiedShellInt   CSG
  158.           XmNminHeight       XmCMinHeight       int       XtUnspecifiedShellInt   CSG
  159.           XmNminWidth        XmCMinWidth        int       XtUnspecifiedShellInt   CSG
  160.           XmNtitle           XmCTitle           String    dynamic                 CSG
  161.           XmNtitleEncoding   XmCTitleEncoding   Atom      dynamic                 CSG
  162.           XmNtransient       XmCTransient       Boolean   False                   CSG
  163.           XmNwaitForWm       XmCWaitForWm       Boolean   True                    CSG
  164.           XmNwidthInc        XmCWidthInc        int       XtUnspecifiedShellInt   CSG
  165.           XmNwindowGroup     XmCWindowGroup     Window    dynamic                 CSG
  166.           XmNwinGravity      XmCWinGravity      int       dynamic                 CSG
  167.           XmNwmTimeout       XmCWmTimeout       int       5000 ms                 CSG
  168.  
  169.                                                    SSSShhhheeeellllllll RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  170.           NNNNaaaammmmeeee                      CCCCllllaaaassssssss                     TTTTyyyyppppeeee                     DDDDeeeeffffaaaauuuulllltttt          AAAAcccccccceeeessssssss
  171.           XmNallowShellResize       XmCAllowShellResize       Boolean                  False            CG
  172.           XmNcreatePopupChildProc   XmCCreatePopupChildProc   XtCreatePopupChildProc   NULL             CSG
  173.           XmNgeometry               XmCGeometry               String                   NULL             CSG
  174.           XmNoverrideRedirect       XmCOverrideRedirect       Boolean                  False            CSG
  175.           XmNpopdownCallback        XmCCallback               XtCallbackList           NULL             C
  176.           XmNpopupCallback          XmCCallback               XtCallbackList           NULL             C
  177.           XmNsaveUnder              XmCSaveUnder              Boolean                  False            CSG
  178.           XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG
  179.  
  180.                                   CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  181.           NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  182.           XmNchildren         XmCReadOnly         WidgetList    NULL      G
  183.           XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  184.           XmNnumChildren      XmCReadOnly         Cardinal      0         G
  185.  
  186.                                                         CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  187.           NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  188.           XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  189.           XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                         (printed 10/24/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      TTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVTTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))
  203.  
  204.  
  205.  
  206.           XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  207.           XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  208.           XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  209.           XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  210.           XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  211.           XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  212.           XmNdepth                        XmCDepth                        int              dynamic                CG
  213.           XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  214.           XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  215.           XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  216.           XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  217.           XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  218.           XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  219.           XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  220.           XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  221.           XmNx                            XmCPosition                     Position         0                      CSG
  222.           XmNy                            XmCPosition                     Position         0                      CSG
  223.  
  224.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  225.           There are no translations for TopLevelShell.
  226.  
  227.      RRRREEEELLLLAAAATTTTEEEEDDDD
  228.           CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooorrrreeee(3), SSSShhhheeeellllllll(3), WWWWMMMMSSSShhhheeeellllllll(3), and
  229.           VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll(3).
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                         (printed 10/24/98)
  262.  
  263.  
  264.  
  265.